home *** CD-ROM | disk | FTP | other *** search
/ Internet Surfer 2.0 / Internet Surfer 2.0 (Wayzata Technology) (1996).iso / pc / text / mac / faqs.314 < prev    next >
Encoding:
Text File  |  1996-02-12  |  27.6 KB  |  718 lines

  1. Frequently Asked Questions (FAQS);faqs.314
  2.  
  3.  
  4. Section 8: Ordering foreign game magazines:
  5. ==========================================
  6.  
  7. The below information comes from James Mathiesen:  To order a British
  8. magazine, call first; pay with a VISA card or an International Money Order:
  9.  
  10. Title: Computer + Video Games  (computer and console games)
  11. Title: Nintendo Magazine System Mean Machines (Nintendo)
  12. Title: Mean Machines Sega (Sega)
  13. Phone: (0858) 410510
  14.  
  15. Title: ZONE (console games)
  16. Phone: (071) 580 8908
  17.  
  18. Title: Sega Pro (Sega only)
  19. Phone: (0225) 765086
  20.  
  21. Title: Sega Force (Sega only)
  22. Phone: (051) 357 1275
  23.  
  24. Title: TOTAL (Nintendo only)
  25. Phone: (0458) 74011
  26.  
  27.  
  28. Section 9: Other FAQ's and regular postings:
  29. ===========================================
  30.  
  31. Anime video games list: maintained by Steve Pearl (pearl@remus.rutgers.edu).
  32. The list can be ftp'ed from romulus.rutgers.edu (128.6.13.2).
  33.  
  34. Japanese video game source list: ditto.
  35.  
  36. The Lynx cheat list is on terminator.cc.umich.edu in /atari/lynx.  (Or it was
  37. supposed to be, anyway.  I checked, and it's not there.)
  38.  
  39. Lynx FAQ: maintained by Robert Jung (rjung@aludra.usc.edu).
  40.  
  41. SNES spoiler list: maintained by Robert Deloura (deloura@noaapmel.gov)
  42.  
  43. Genesis spoiler list: maintained by Bob Rusbasan
  44. (rusbasan@expert.cc.purdue.edu).
  45.  
  46. Megadrive spoilers: collected by Galen Komatsu (gkomatsu@uhunix.uhcc.hawaii.
  47. edu).  Not in list form.
  48.  
  49. TG-16 cheat list/FAQ: maintained by Steve Pearl (pearl@remus.rutgers.edu).
  50.  
  51. Vectrex FAQ: maintained by Gregg Woodcock (woodcock@sdf.lonestar.org).
  52.  
  53. Genesis joystick pinouts: an article was posted by nhowland@matt.ksu.ksu.edu.
  54. I presume he'd be able to send you a copy of the article, or if not, I saved
  55. one; it's too long to include here.
  56. --
  57. "the bogosity in a field equals the bogosity imported from related areas, plus
  58. the bogosity generated internally, minus the bogosity expelled or otherwise
  59. disposed of."  -- K. Eric Drexler
  60.  
  61. Ken Arromdee (arromdee@jyusenkyou.cs.jhu.edu, arromdee@jhunix.hcf.jhu.edu)
  62. Xref: bloom-picayune.mit.edu gnu.g++.help:2790 comp.lang.c++:34580 news.answers:4675
  63. Path: bloom-picayune.mit.edu!enterpoop.mit.edu!news.media.mit.edu!micro-heart-of-gold.mit.edu!news.bbn.com!olivea!sun-barr!cs.utexas.edu!zaphod.mps.ohio-state.edu!magnus.acs.ohio-state.edu!usenet.ins.cwru.edu!agate!agate!usenet
  64. From: jbuck@ohm.berkeley.edu (Joe Buck)
  65. Newsgroups: gnu.g++.help,comp.lang.c++,news.answers
  66. Subject: FAQ for g++ and libg++, plain text version [Revised 16 Dec 1992]
  67. Message-ID: <1goh6uINN4mq@agate.berkeley.edu>
  68. Date: 17 Dec 92 00:21:50 GMT
  69. Expires: +1 month
  70. Followup-To: poster
  71. Organization: University of California, Berkeley
  72. Lines: 613
  73. Approved: news-answers-request@MIT.edu
  74. NNTP-Posting-Host: forney.berkeley.edu
  75.  
  76. Archive-name: g++-FAQ/plain
  77. Last-modified: 16 Dec 1992
  78. Frequency: bimonthly
  79.  
  80. [ this is the plain text version, the parent is the texinfo version ]
  81. Preface
  82. *******
  83.  
  84.    This is a list of frequently asked questions for g++ users; thanks
  85. to all those who sent suggestions for improvements.
  86.  
  87.    I'm looking for new questions, better answers, or both.  One thing
  88. that's missing is a section on templates and template problems with
  89. g++; I'm looking for contributions on this score.
  90.  
  91.    This FAQ is intended to supplement, not replace, Marshall Cline's
  92. excellent FAQ for comp.lang.c++.  Especially if g++ is the first C++
  93. compiler you've ever used, the question "How do I do <X> with g++?" is
  94. probably really "How do I do <X> in C++?".  You can obtain the C++ FAQ
  95. by anonymous FTP from sun.soe.clarkson.edu [128.153.12.3], in the file
  96. ~ftp/pub/C++/FAQ.  (There is also a mail server for that FAQ, but it
  97. seems to be broken).
  98.  
  99.  
  100. Obtaining Source Code
  101. *********************
  102.  
  103.  
  104. How do I get a copy of g++ for Unix?
  105. ====================================
  106.  
  107.    First, you may already have it if you have gcc for your platform;
  108. see the answer to question 3.
  109.  
  110.    If you're trying to find g++, you can get it by anonymous FTP, by
  111. anonymous UUCP, by buying a tape from the Free Software Foundation, or
  112. by getting it from a friend that has it.
  113.  
  114.    Here is a list of anonymous FTP archive sites for Gnu software.
  115.  
  116.      Japan: ftp.cs.titech.ac.jp, utsun.s.u-tokyo.ac.jp:ftpsync/prep
  117.      Australia: archie.au:gnu
  118.      Europe: src.doc.ic.ac.uk:gnu, ftp.informatik.tu-muenchen.de,
  119.          ftp.informatik.rwth-aachen.de:pub/gnu,
  120.          nic.funet.fi:pub/gnu, ugle.unit.no, isy.liu.se,
  121.          ftp.stacken.kth.se, sunic.sunet.se, ftp.win.tue.nl,
  122.          ftp.diku.dk, ftp.eunet.ch, archive.eu.net
  123.      United States: wuarchive.wustl.edu, ftp.cs.widener.edu,
  124.          uxc.cso.uiuc.edu, col.hp.com, gatekeeper.dec.com:pub/GNU,
  125.          ftp.uu.net:packages/gnu
  126.  
  127.    The "official site" is prep.ai.mit.edu, but your transfer will
  128. probably go faster if you use one of the above machines.
  129.  
  130.    Users of the HP Precision Architecture (HP-9000/7xx and
  131. HP-9000/8xx) may want to use the "2.3.1-u2" version available from the
  132. University of Utah, site jaguar.cs.utah.edu.  This version supports
  133. debugging provided that gas is used (you need the version of gas
  134. available from the same place) and has several bug fixes that weren't
  135. done in time for the 2.3.2 release.  Precompiled binaries of gcc and
  136. gdb can also be obtained from that site.  Hopefully this will all be
  137. folded in to 2.4.
  138.  
  139.    UUNET customers can get Gnu sources from UUNET via UUCP.  For
  140. information on how to order tapes from FSF, write to
  141. gnu@prep.ai.mit.edu.
  142.  
  143.    UUCP-only sites can get Gnu sources by "anonymous UUCP" from site
  144. "osu-cis" at Ohio State University.  You pay for the long-distance call
  145. to OSU; the price isn't too bad on weekends at 9600 bps.  Send mail to
  146. uucp@cis.ohio-state.edu or osu-cis!uucp for more information.
  147.  
  148.    OSU lines are often busy.  If you're in the USA, and are willing to
  149. spend more money, you can get sources via UUCP from UUNET using their
  150. 900 number: 1-900-GOT-SRCS (900 numbers don't work internationally).
  151. You will be billed $0.50/minute by your phone company.
  152.  
  153.    Don't forget to retrieve libg++ as well!
  154.  
  155.  
  156. How do I get a copy of g++ for (some other platform)?
  157. =====================================================
  158.  
  159.    The standard gcc/g++ distribution includes VMS support.  Since the
  160. FSF people don't use VMS, it's likely to be somewhat less solid than
  161. the Unix version.  Precompiled copies of G++ and libg++ in
  162. VMS-installable form are available by FTP from mango.rsmas.miami.edu.
  163.  
  164.    DJ Delorie has ported gcc/g++ to MS-DOS; this port is popularly
  165. known as "DJGPP" (the P's stand for "plus").  It can be found on many
  166. FTP archive sites; its "home" is on grape.ecs.clarkson.edu, directory
  167. ~ftp/pub/msdos/djgpp.  Make sure you're retrieving the current version,
  168. which should indicate that it is a port of gcc-2.2.2 (2.3.1 and 2.3.2
  169. have been released since then, but I don't think the DOS port is done
  170. yet).  It is also available on site wuarchive.wustl.edu, in directory
  171. mirrors/msdos/djgpp, and many other places as well.
  172.  
  173.    For information on Amiga ports of gcc/g++, retrieve the file
  174. /pub/gnu/MicrosPorts/Amiga from prep.ai.mit.edu, or write to Leonard
  175. Norrgard <vinsci@nic.funet.fi>, who I hope won't be too upset that I
  176. mentioned his name here.
  177.  
  178.    A port of gcc-2.3.1 to the Atari ST can be found on the site
  179. "atari.archive.umich.edu", under /atari/Gnustuff/Tos, along with many
  180. other Gnu programs.  See the FAQ for the Usenet group
  181. "comp.sys.atari.st" for more information.
  182.  
  183.    There are two different ports of gcc-2.2.2 (and g++) to OS/2, the
  184. so-called EMX port, which requires a particular Unix emulator, and a
  185. port called "gcc/2", which runs native.  The latter port uses a rather
  186. buggy port of the BSD libc.  For more information ask around on
  187. comp.os.os2.programmer.  gcc/2 can be obtained by FTP from
  188.  
  189.      ftp-os2.nmsu.edu (128.123.35.151) in /pub/os2/2.0/programming/gcc2-222
  190.      luga.latrobe.edu.au (131.172.2.2) in /pub/os2/2.0/programming/gcc2-222
  191.  
  192.    Eberhard Mattes did the EMX port.  Tevor Lampre did the gcc/2 port.
  193. Their addresses are mattes@azu.informatik.uni-stuttgart.de and
  194. mmtl@cc.flinders.edu.au, repectively.
  195.  
  196.    Because the legal policies of Apple threaten the long-term goals of
  197. FSF, as well as the concept of free software, no support will be lent
  198. to efforts to port Gnu software to Macintosh or other Apple hardware.
  199.  
  200.  
  201. But I can only find g++-1.42!
  202. =============================
  203.  
  204.    "I keep hearing people talking about g++ 2.3.2 (or some other number
  205. starting with 2), but the latest version I can find is g++ 1.42.
  206. Where is it?"
  207.  
  208.    As of gcc 2.0, C, C++, and Objective-C as well are all combined
  209. into a single distribution called gcc.  If you get gcc you already
  210. have g++.  The standard installation procedure for any gcc version 2
  211. compiler will install the C++ compiler as well.
  212.  
  213.    One could argue that we shouldn't even refer to "g++-2.x.y" but
  214. it's a convention.  It means "the C++ compiler included with
  215. gcc-2.x.y".
  216.  
  217.  
  218. What is the latest version of gcc, g++, and libg++?
  219. ===================================================
  220.  
  221.    The latest "2.x" version of gcc/g++ is 2.3.2, released Nov 27, 1992.
  222. The latest version of libg++ is 2.3, released Dec 9, 1992.
  223.  
  224.    For some non-Unix platforms, 2.2.2 may be the latest compiler that
  225. has been ported.  libg++ 2.3 will not compile with gcc-2.2.2.  Also,
  226. due to a newly introduced compiler bug, libg++ 2.2 will not compile
  227. with gcc-2.3.1 or gcc-2.3.2.
  228.  
  229.    The latest "1.x" version of gcc is 1.42, and the latest "1.x"
  230. version of g++ is 1.42.0.
  231.  
  232.  
  233. I have gcc-2.2.2 and libg++-2.2.  Should I upgrade to the new versions?
  234. =======================================================================
  235.  
  236.    Unfortunately, this question cannot be answered with a simple yes
  237. or no.  gcc-2.3.x made some significant improvements in template
  238. support; however, at the same time, quite a few new bugs were
  239. introduced in 2.3.1, particularly in resolving of overloaded
  240. functions.  2.3.2 fixed some of them, but serious problems remain (for
  241. example, 2.3.2 cannot compile some perfectly correct code in
  242. libg++-2.2).  Given this, I would recommend that those not using
  243. templates wait for a more stable release (gcc-2.3.3 should be out
  244. soon).  If you're using templates and 2.2.2 won't cut it for you, by
  245. all means upgrade.
  246.  
  247.  
  248. Installation Issues and Problems
  249. ********************************
  250.  
  251.  
  252. I can't build g++ 1.x.y with gcc-2.x.y!
  253. =======================================
  254.  
  255.    "I obtained gcc-2.x.y and g++ 1.x.y and I'm trying to build it, but
  256. I'm having major problems.  What's going on?"
  257.  
  258.    If you wish to build g++-1.42, you must obtain gcc-1.42 first.  The
  259. installation instructions for g++ version 1 leave a lot to be desired,
  260. unfortunately, and I would recommend that, unless you have a special
  261. reason for needing the 1.x compiler, that C++ users use g++-2.3.2, as
  262. it is the version that is being actively maintained.
  263.  
  264.    There is no template support in g++-1.x, and it is generally much
  265. further away from the ANSI draft standard than g++-2.x is.
  266.  
  267.  
  268. OK, I've obtained gcc; what else do I need?
  269. ===========================================
  270.  
  271.    First off, you'll want libg++ as you can do almost nothing without
  272. it (unless you replace it with some other class library).
  273.  
  274.    Second, depending on your platform, you may need "gas", the Gnu
  275. assembler, or the Gnu linker (see next question).
  276.  
  277.  
  278. Should I use the Gnu linker, or should I use "collect"?
  279. =======================================================
  280.  
  281.    First off, for novices: special measures must be taken with C++ to
  282. arrange for the calling of constructors for global or static objects
  283. before the execution of your program, and for the calling of
  284. destructors at the end.  (Exception: System VR3 and System VR4 linkers
  285. support user-defined segments; g++ on these systems requires neither
  286. the Gnu linker nor collect.  So if you have such a system, the answer
  287. is that you don't need either one).
  288.  
  289.    If you have experience with AT&T's "cfront", this function is
  290. performed there by programs named "patch" or "munch".  With Gnu C++,
  291. it is performed either by the Gnu linker or by a program known as
  292. "collect".  The collect program is part of the gcc-2.x distribution;
  293. you can obtain the Gnu linker separately as part of the "binutils"
  294. package.
  295.  
  296.    (To be technical, it's "collect2"; there were originally several
  297. alternative versions of collect, and this is the one that survived).
  298.  
  299.    There are advantages and disadvantages to either choice.
  300.  
  301.    Advantages of the Gnu linker:
  302.  
  303.    It's faster than using collect -- collect basically runs the
  304. standard Unix linker on your program twice, inserting some extra code
  305. after the first pass to call the constructors.  This is a sizable time
  306. penalty for large programs.  The Gnu linker does not require this
  307. extra pass.
  308.  
  309.    Gnu ld reports undefined symbols using their true names, not the
  310. mangled names.
  311.  
  312.    If there are undefined symbols, Gnu ld reports which object file(s)
  313. refer to the undefined symbol(s).
  314.  
  315.    Advantages of collect:
  316.  
  317.    If your native linker supports shared libraries, you can use shared
  318. libraries with collect.  The Gnu linker does not (yet) support shared
  319. libraries.
  320.  
  321.    The Gnu linker has not been ported to as many platforms as g++ has,
  322. so you may be forced to use collect.
  323.  
  324.    If you use collect, you don't need to get something extra and
  325. figure out how to install it; the standard gcc installation procedure
  326. will do it for you.
  327.  
  328.    In conclusion, I don't see a clear win for either alternative at
  329. this point.  Take your pick.
  330.  
  331.  
  332. Should I use the Gnu assembler, or my vendor's assembler?
  333. =========================================================
  334.  
  335.    This depends on your platform and your decision about the Gnu
  336. linker.  For most platforms, you'll need to use gas if you use the Gnu
  337. linker.  For some platforms, you have no choice; check the gcc
  338. installation notes to see whether you must use gas.  But you can
  339. usually use the vendor's assembler if you don't use the Gnu linker.
  340.  
  341.    The Gnu assembler assembles faster than many native assemblers;
  342. however, on many platforms it cannot support the local debugging
  343. format.
  344.  
  345.  
  346. Should I use the Gnu C library?
  347. ===============================
  348.  
  349.    At this point in time, no.  The Gnu C library is still very young,
  350. and libg++ still conflicts with it in some places.  Use your native C
  351. library unless you know a lot about the gory details of libg++ and
  352. gnu-libc.  This will probably change in the future.
  353.  
  354.  
  355. Problems building libg++ on Ultrix
  356. ==================================
  357.  
  358.    "I am having trouble building libg++-2.2 on Ultrix [and possibly
  359. other systems].  I get errors referring to "dummy.o".  Help!"
  360.  
  361.    (The errors on Ultrix end with something like
  362.  
  363.      ldopen: cannot open dummy.o
  364.      nm: Error: cannot open dummy.o
  365.      ldopen: cannot open dummy.o
  366.      nm: Error: cannot open dummy.o
  367.      nm failed to find FUNC in dummy.o!
  368.      sh: -1: bad number
  369.      *** Error code 1
  370.  
  371. and there may be similar problems on other systems).
  372.  
  373.    The fix for this is to make libg++ by saying "make CC=gcc".
  374.  
  375.  
  376. User Problems
  377. *************
  378.  
  379.  
  380. Linker reports undefined symbols for static data members
  381. ========================================================
  382.  
  383.    "g++ reports undefined symbols for all my static data members when
  384. I link, even though the program works correctly for compiler XYZ.
  385. What's going on?"
  386.  
  387.    The problem is almost certainly that you don't give definitions for
  388. your static data members.  If you have
  389.  
  390.      class Foo {
  391.          ...
  392.          void method();
  393.          static int bar;
  394.      };
  395.  
  396.    you have only declared that there is an int named Foo::bar and a
  397. member function named Foo::method that is defined somewhere.  You
  398. still need to defined BOTH method() and bar in some source file.
  399. According to the draft ANSI standard, you must supply an initializer,
  400. such as
  401.  
  402.      int Foo::bar = 0;
  403.  
  404. in one (and only one) source file.
  405.  
  406.  
  407. g++ won't accept the placement new syntax.
  408. ==========================================
  409.  
  410.    "I have a program that uses the "placement syntax" of operator new,
  411. e.g.
  412.  
  413.         new (somewhere) T;
  414.  
  415. and g++ won't accept it."
  416.  
  417.    Up until version 2.3.1, g++ accepted an alternate form of the
  418. placement syntax, for historical reasons; use
  419.  
  420.         new {somewhere} T;
  421.  
  422. if you are using g++-2.2.2 or older.
  423.  
  424.    As of 2.3.1, g++ finally fixed this, using the standard ARM syntax
  425. for "placement new".  A few remaining glitches were fixed in 2.3.2.
  426. The only remaining problem is with declarators for pointers to
  427. functions;
  428.  
  429.      new (void (*)(int));  // confuses gcc 2.3.2
  430.      new (a) (void (*)(int)); // ditto
  431.  
  432.    These can be worked around with a typedef:
  433.  
  434.      typedef void (*fun)(int);
  435.      new fun;
  436.      new (a) fun;
  437.  
  438.  
  439. I think I have found a bug in g++.
  440. ==================================
  441.  
  442.    "I think I have found a bug in g++, but I'm not sure.  How do I
  443. know, and who should I tell?"
  444.  
  445.    First, see the excellent section on bugs and bug reports in the gcc
  446. manual (which is included in the gcc distribution).  As a short
  447. summary of that section: if the compiler gets a fatal signal, for any
  448. input, it's a bug.  Same thing for producing invalid assembly code.
  449.  
  450.    I will add some extra notes that are C++-specific, since the notes
  451. from gcc are generally C-specific.
  452.  
  453.    First, mail your bug report to "bug-g++@prep.ai.mit.edu".  You may
  454. also post to gnu.bug.g++, but it's better to use mail, particularly if
  455. you any doubt as to whether your news software generates correct reply
  456. addresses.  Don't mail C++ bugs to bug-gcc@prep.ai.mit.edu.
  457.  
  458.    If your bug involves libg++ rather than the compiler, mail to
  459. bug-libg++@prep.ai.mit.edu.  If you're not sure, you could send your
  460. bug to both lists.
  461.  
  462.    Second, if your program does one thing, and you think it should do
  463. something else, it is best to consult a good reference if in doubt.
  464. The standard reference is "The Annotated C++ Reference Manual", by
  465. Ellis and Stroustrup (copyright 1990, ISBN #0-201-51459-1); the
  466. reference manual, without annotations, also appears in Stroustrup's
  467. "The C++ Programming Language, Second Edition" (copyright 1991, ISBN
  468. #0-201-53992-6).  Both are published by Addison-Wesley.
  469.  
  470.    Note that the behavior of (any version of) AT&T's "cfront" compiler
  471. is NOT the standard for the language.
  472.  
  473.  
  474. Porting programs from other compilers to g++
  475. ============================================
  476.  
  477.    "I have a program that runs on <some other C++ compiler>, and I want
  478. to get it running under g++.  Is there anything I should watch out
  479. for?"
  480.  
  481.    First, see the questions on placement new syntax and static data
  482. members.
  483.  
  484.    There are two other reasons why a program that worked under one
  485. compiler might fail under another: your program may depend on the
  486. order of evaluation of side effects in an expression, or it may depend
  487. on the lifetime of a temporary (you may be assuming that a temporary
  488. object "lives" longer than the standard guarantees).  As an example of
  489. the first:
  490.  
  491.        void func(int,int);
  492.  
  493.        int i = 3;     func(i++,i++);
  494.  
  495.    Novice programmers think that the increments will be evaluated in
  496. strict left-to-right order.  Neither C nor C++ guarantees this; the
  497. second increment might happen first, for example.  func might get 3,4,
  498. or it might get 4,3.
  499.  
  500.    The second problem often happens with classes like the libg++ String
  501. class.  Let's say I have
  502.  
  503.    String func1(); void func2(const char*);
  504.  
  505.    and I say
  506.  
  507.    func2(func1());
  508.  
  509.    because I know that class String has an "operator const char*".  So
  510. what really happens is
  511.  
  512.    func2(func1().convert());
  513.  
  514.    where I'm pretending I have a convert() method that is the same as
  515. the cast.  This is unsafe, because the temporary String object may be
  516. deleted after its last use (the call to the conversion function),
  517. leaving the pointer pointing to garbage, so by the time func2 is
  518. called, it gets an invalid argument.
  519.  
  520.    If you think this is ugly, you should know that the ANSI C++
  521. committee is STILL debating the lifetime-of-temporaries problem.
  522.  
  523.    For now, the safe way to write such code is to give the temporary a
  524. name, which forces it to live until the end of the scope of the name.
  525. For example:
  526.  
  527.        String& tmp = func1();     func2(tmp);
  528.  
  529.    Finally, like all compilers (but especially C++ compilers, it
  530. seems), g++ has bugs, and you may have tweaked one.
  531.  
  532.  
  533. Why does g++ mangle names differently from other C++ compilers?
  534. ===============================================================
  535.  
  536.    See the answer to the next question.
  537.  
  538.  
  539. Why can't g++ code link with code from other C++ compilers?
  540. ===========================================================
  541.  
  542.    "Why can't I link g++-compiled programs against libraries compiled
  543. by some other C++ compiler?"
  544.  
  545.    Some people think that, if only the FSF and Cygnus folks would stop
  546. being stubborn and mangle names the same way that, say, cfront does,
  547. then any g++-compiled program would link successfully against any
  548. cfront-compiled library and vice versa.  Name mangling is the least of
  549. the problems.  Compilers differ as to how objects are laid out, how
  550. multiple inheritance is implemented, how virtual function calls are
  551. handled, and so on, so if the name mangling were made the same, your
  552. programs would link against libraries provided from other compilers
  553. but then crash when run.  For this reason, the ARM *encourages*
  554. compiler writers to make their name mangling different from that of
  555. other compilers for the same platform.  Incompatible libraries are
  556. then detected at link time, rather than at run time.
  557.  
  558.  
  559. What documentation exists for g++ 2.x?
  560. ======================================
  561.  
  562.    Almost none.  The gcc manual describes the C front end, and also
  563. the back end, which is shared by the C++ compiler, but there is almost
  564. no documentation for the C++ front end.  There is a Unix-style manual
  565. entry, "g++.1", in the gcc-2.x distribution; this describes the extra
  566. command-line options that g++ supports, and the #pragma interface and
  567. #pragma implementation directives.
  568.  
  569.    A draft of a document describing the g++ internals appears in the
  570. 2.3.2 distribution (called g++int.texi); it is still incomplete.
  571.  
  572.    Work is proceeding on a user g++ document; with luck it will appear
  573. in the next release.
  574.  
  575.  
  576. What are the differences between g++ and the ARM specification of C++?
  577. ======================================================================
  578.  
  579.    The chief thing missing from g++ that is in the ARM is exceptions
  580. (the other major compilers do not have exceptions either).  There are
  581. bits and pieces of exception code present, but it is not presently
  582. usable.
  583.  
  584.    While, as of 2.3.1, the "placement new" syntax finally agrees with
  585. the ARM, there are still some problems with it.
  586.  
  587.    The template implementation is still new.  The implementation in
  588. 2.3.2 represents a considerable improvement over that of previous
  589. releases, however.  Still, it has many bugs.
  590.  
  591.    g++ does not implement a separate pass to instantiate template
  592. functions and classes at this point; for this reason, it will not
  593. work, for the most part, to declare your template functions in one
  594. file and define them in another.  The compiler will need to see the
  595. entire definition of the function, and will generate a static copy of
  596. the function in each file in which it is used.
  597.  
  598.    As with any beta-test compiler, there are bugs.  You can help
  599. improve the compiler by submitting detailed bug reports.
  600.  
  601.    [A full bug list would be very long indeed, so I won't put one here.
  602. I may add a list of frequently-reported bugs and "non-bugs" like the
  603. static class members issue mentioned above].
  604.  
  605.  
  606. Will g++ compile InterViews?  The NIH class library?
  607. ====================================================
  608.  
  609.    The NIH class library uses a non-portable, compiler-dependent hack
  610. to initialize itself, which makes life difficult for g++ users.  It
  611. will not work without modification, and I don't know what modifications
  612. are required or whether anyone has done them successfully.
  613.  
  614.    Brendan Kehoe of Cygnus is working on getting NIHCL to build with
  615. g++.  He says, "The NIHCL release will hopefully contain patches to
  616. gcc 2.3 to let it build."
  617.  
  618.    [ From Stienar Bang <steinarb@idt.unit.no> ]
  619.  
  620.    The C++ compiler part of gcc-2.3 (when released) *should* be able to
  621. compile InterViews release 3.1 (when released) out of the box (no
  622. patches required on either side).
  623.  
  624.    [ Now that 2.3.1 is out, is this true? ]
  625.  
  626.  
  627. Debugging on SVR4 systems
  628. =========================
  629.  
  630.    "When I use the -g flag on C++ code on a System V Release 4 system,
  631. I get lots of undefined symbols at link time.  Why?  Help!"
  632.  
  633.    [From Ron Guilmette:] The changes needed to get the g++ front-end
  634. to generate proper DWARF style debugging information for System V
  635. Release 4 are not yet completed, nor will they be until g++ version
  636. 2.4 (at the earliest).
  637.  
  638.    There is nothing that you (as an end-user) can do to correct this
  639. problem.  (It is actually *many* problems, and they are all very
  640. complex.)  Until the g++ maintainers have time to fix this, you should
  641. simply *avoid* using the -g option when using g++ on SVR4.
  642.  
  643.  
  644. What are the rules for shipping code built with g++ and libg++?
  645. ***************************************************************
  646.  
  647.    "Is it is possible to distribute programs for profit that are
  648. created with g++ and use the g++ libraries?"
  649.  
  650.    I am not a lawyer, and this is not legal advice.  In any case, I
  651. have little interest in telling people how to violate the spirit of the
  652. Gnu licenses without violating the letter.  This section tells you how
  653. to comply with the intention of the Gnu licenses as best I understand
  654. them.
  655.  
  656.    The FSF has no objection to your making money.  Its only interest
  657. is that source code to their programs, and libraries, and to modified
  658. versions of their programs and libraries, is always available.
  659.  
  660.    The short answer is that you do not need to release the source to
  661. your program, but you can't just ship a stripped executable either.
  662.  
  663.    Compiling your code with a Gnu compiler does not affect its
  664. copyright; it is still yours.  However, in order to ship code that
  665. links in a Gnu library such as libg++ there are certain rules you must
  666. follow.  The rules are described in the file COPYING.LIB that
  667. accompanies gcc distributions; it is also included in the libg++
  668. distribution.  See that file for the exact rules.  The agreement is
  669. called the Library Gnu Public License or LGPL.  It is much "looser"
  670. than the Gnu Public License, or GPL, that covers must Gnu programs.
  671.  
  672.    Here's the deal: let's say that you use some version of libg++,
  673. completely unchanged, in your software, and you want to ship only a
  674. binary form of your code.  You can do this, but there are several
  675. special requirements.  If you want to use libg++ but ship only object
  676. code for your code, you have to ship source for libg++ (or ensure
  677. somehow that your customer already has the source for the exact
  678. version you are using), and ship your application in linkable form.
  679. You cannot forbid your customer from reverse-engineering or extending
  680. your program by exploiting its linkable form.
  681.  
  682.    Furthermore, if you modify libg++ itself, you must provide source
  683. for your modifications (making a derived class does not count as
  684. modifying the library -- that is "a work that uses the library").
  685.  
  686.  
  687. --
  688. Joe Buck    jbuck@ohm.berkeley.edu
  689. Xref: bloom-picayune.mit.edu gnu.g++.help:2789 comp.lang.c++:34579 news.answers:4674
  690. Path: bloom-picayune.mit.edu!enterpoop.mit.edu!news.media.mit.edu!micro-heart-of-gold.mit.edu!news.bbn.com!noc.near.net!uunet!zaphod.mps.ohio-state.edu!magnus.acs.ohio-state.edu!usenet.ins.cwru.edu!agate!agate!usenet
  691. From: jbuck@ohm.berkeley.edu (Joe Buck)
  692. Newsgroups: gnu.g++.help,comp.lang.c++,news.answers
  693. Subject: FAQ for g++ and libg++, texinfo version [Revised 16 Dec 1992]
  694. Followup-To: poster
  695. Date: 17 Dec 1992 00:21:43 GMT
  696. Organization: University of California, Berkeley
  697. Lines: 665
  698. Approved: news-answers-request@MIT.edu
  699. Expires: +1 month
  700. Message-ID: <1goh6nINN4mo@agate.berkeley.edu>
  701. NNTP-Posting-Host: forney.berkeley.edu
  702.  
  703. Archive-name: g++-FAQ/texi
  704. Last-modified: 16 Dec 1992
  705. Frequency: bimonthly
  706.  
  707. [ This is the texinfo version.  If you don't know what texinfo is,
  708.   then you probably want to use the companion plain-text version. ]
  709.  
  710. ------------- cut here ----------------------------------------------
  711. \input texinfo.tex      @c -*-texinfo-*-
  712. @c %**start of header
  713. @setfilename g++FAQ.info
  714. @settitle Frequently asked questions about the Gnu C++ compiler
  715. @setchapternewpage odd
  716. @c version: %W% %G%
  717. @c %**end of header
  718.